home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / CD32 / CD32_Support / examples / SA_Examples / lowlevel / KBInt / KBInt.doc < prev    next >
Encoding:
Text File  |  1993-08-31  |  1.7 KB  |  61 lines
  1. KBInt
  2.  
  3. NAME
  4.     KBInt -- lowlevel.library/AddKBInt() and RemKBInt() Test Program
  5.  
  6. SYNOPSIS
  7.     CLI:
  8.         KBInt
  9.  
  10.     Workbench:
  11.         KBInt
  12.  
  13. FUNCTION
  14.     KBInt is a part of a series of test programs for lowlevel.library.
  15.     The purpose of KBInt is to test the lowlevel.library/AddKBInt() and
  16.     RemKBInt() functions by installing a keyboard interrupt handler
  17.     and displaying all keystrokes.
  18.  
  19.     The Key text gadget displays the ANSI mapping of the keystroke
  20.     in the default keymap (if available).
  21.  
  22.     The Code number gadget displays the raw key code of the keystroke.
  23.  
  24.     The eight qualifier checkbox gadgets display the status of each
  25.     qualifier:
  26.         LShift      -   <Left Shift>
  27.         RShift      -   <Right Shift>
  28.         Caps Lock   -   <Caps Lock>
  29.         Control     -   <Control>
  30.         LAlt        -   <Left Alt>
  31.         RAlt        -   <Right Alt>
  32.         LAmiga      -   <Left Amiga>
  33.         RAmiga      -   <Right Amiga>
  34.  
  35.     To terminate KBInt, select the close gadget of the window.
  36.  
  37. INPUTS
  38.     None
  39.  
  40. RESULT
  41.     RETURN_OK (0)       -   Success
  42.     RETURN_WARN (5)     -   Warning
  43.     RETURN_FAIL (20)    -   Failure
  44.  
  45. EXAMPLE
  46.  
  47. NOTES
  48.     To ensure that the specified user data for the keyboard interrupt
  49.     handler is correctly received, the keyboard interrupt handler
  50.     compares the interrupt data against a magic cookie. If any calls
  51.     to interrupt routine had incorrect interrupt data, the user is
  52.     notified when the program exits and a warning (RETURN_WARN (5))
  53.     is returned by KBInt.
  54.  
  55. BUGS
  56.     If keyboard interrupts occur faster than keyboard update
  57.     routine can display changes, some keyboard events will not
  58.     be displayed.
  59.  
  60. SEE ALSO
  61.